﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Run / RunWait</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="../css/commands.css" type="text/css" rel="stylesheet">
<link media="print" href="../css/print.css" type="text/css" rel="stylesheet">
<style type="text/css">
<!--
.style3 {color: #FF0000; font-weight: bold; }
-->
</style>
</head>
<body>

<h1>Run / RunWait</h1>

<p>运行一外部程序。与 Run 不同，RunWait 会等待运行的程序结束再继续下一行命令。</p>

<p class="CommandSyntax">Run, Target [, WorkingDir, Max|Min|Hide|UseErrorLevel, OutputVarPID]</p>

<h3>参数 </h3>

<table border="1" bordercolor="#c0c0c0" cellpadding="3" cellspacing="0" width="100%">
<tr>
<td width="15%">Target</td>
<td width="85%">
<p>运行一文档、网址、可执行文件（.exe, .com, .bat 等等）、快捷方式(.lnk)或系统动作（见备注）。如果 <em>Target</em> 是个本地文件并且没有给它指定路径，<a href="../Variables.htm#WorkingDir">A_WorkingDir</a> 将先被搜索。如果没在那找到匹配的文件，系统将查找并且运行假如是被整合的(&ldquo;已知&rdquo;)文件，例如通过被包含在 PATH 文件夹其中的一个。（译注：PATH 文件夹应该指的是操作系统环境变量中的 PATH，被包含在这个 PATH 中的文件夹下的文件，都可以按 Win 键+R 后直接输入文件名来运行）</p>
      <p>要传递参数，将他们立即添加在程序或文档名字后面。如果一参数包含空格，将其用双引号括起是最安全的（虽然它也能在某些情况下不需要他们而运作）。</p>
  </td>
  </tr>
  <tr>
    <td>WorkingDir</td>
    <td>被运行项目的工作目录。不要将名称括在双引号中即使它包含空格。如果此参数忽略，脚本所在的工作目录(<a href="../Variables.htm#WorkingDir">A_WorkingDir</a>)将被使用。</td>
    </tr>
  <tr>
    <td>Max|Min|Hide<br>
UseErrorLevel</td>
    <td>
      <p>如果此参数忽略，<em>Target</em> 将只被正常地运行。或者，它能包含一个或多个这些单词：</p>
      <p><strong>Max</strong>: 最大化运行</p>
      <p><strong>Min</strong>: 最小化运行</p>
      <p><strong>Hide</strong>: 隐藏运行（以上任一个不能组合使用）</p>
      <p>注意：一些程序（例如 Calc.exe）不遵守请求的启动状态，因此 Max/Min/Hide 将无效。</p>
      <p><strong><a name="UseErrorLevel"></a>UseErrorLevel</strong>: UseErrorLevel 可单独被指定或加在以上单词后（将它与其他单词用空格分开）。如果命令运行失败，此选项跳过提示对话框，设置 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 为单词 ERROR，并允许<a href="../misc/Threads.htm">当前线程</a>继续。如果命令运行成功，RunWait 将 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 设置为程序的退出代码，Run 设置其为零。</p>
      <p><a name="LastError"></a>当 UseErrorLevel 被指定时，变量 <strong>A_LastError</strong> 被设置成操作系统的 GetLastError() 函数的结果。A_LastError 是一个在 0 与 4294967295 之间的数字（总为十进制格式，不是十六进制）。零（0）意味着成功，除此之外其他数字意味着运行失败。每一数字相当于一个特定的错误状态（要取得一个列表，在 <a href="http://www.microsoft.com">www.microsoft.com</a> 以&ldquo;system error codes&rdquo;搜索）。与 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 相同，A_LastError 是一个独立线程设定；也就是说，被其他<a href="../misc/Threads.htm">线程</a>打断并不能改变它。但是 A_LastError 也能被 <a href="DllCall.htm#LastError">DllCall</a> 设定。</p></td>
  </tr>
  <tr>
    <td>OutputVarPID</td>
    <td><p>变量的名字用来储存最近运行的程序的唯一 <a href="Process.htm">Process ID (PID)</a>。如果 PID 不能被定义，变量将为空，其通常发生在一个系统动作、文档或快捷方式被运行，而不是一个直接可执行的文件。RunWait 也支持此参数，尽管它的 <em>OutputVarPID</em> 必须在<a href="../misc/Threads.htm">另一个线程</a>核实（否则，PID 将因为进程在 RunWait 下一行执行的时候终止而无效）。</p>
      <p>在 Run 命令取得一个 PID 后，任何由进程创建的窗口可能还不存在。为了等待至少一个窗口被创建，使用 <em><a href="WinWait.htm">WinWait</a> ahk_pid %OutputVarPID%</em></p></td>
    </tr>
</table>

<h3>ErrorLevel</h3>
<p>Run: 不设置 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 除非使用了 UseErrorLevel(上面的)，这样的话，ErrorLevel 在命令执行失败时被设置成单词 ERROR 或者在成功时设置为 0。</p>
<p>RunWait: 将 ErrorLevel 设为程序的退出代码（一个标记成 32 位的整数型）。如果使用了 UseErrorLevel 且命令执行失败，则 ErrorLevel 被存作单词 ERROR。</p>

<h3>备注</h3>
<p>不同于 Run，RunWait 会等到 <em>Target</em> 关闭或者退出，这时 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被设为程序的退出代码（作为一个标记为 32 位的整数型）。即使有些程序仍在运行，RunWait 也会马上出现返回；这些程序创建了另外的进程。</p>

<p>如果 <em>Target</em> 包含任何逗号，它们一定要像下面的例子里出现的三次一样被<a href="_EscapeChar.htm">转义</a>：</p>
<pre>Run rundll32.exe shell32.dll<span class="style3">`,</span>Control_RunDLL desk.cpl<span class="style3">`,`,</span> 3  <em>;打开 控制面板 &gt; 显示 &gt; 设置 </em></pre>

<p>当通过 <a href="../Variables.htm#ComSpec">Comspec</a> (即 cmd.exe，译注：命令解释程序 cmd.exe 的路径变量) 运行一个程序时--可能因为你需要重定向此程序的输入或输出--如果可执行文件的路径或名字包含空格，整个字串应该被一对外引号括起来。下例中，外引号用红色表示，所有的内引号用黑色表示：<br>
Run %comspec% /c <span class="style3">"</span>"C:\My Utility.exe" "param 1" "second param" &gt;"C:\My File.txt"<span class="style3">"</span></p>

<p>如果 <em>Target</em> 不能被运行，将显示一个错误提示窗口，这之后脚本会表现为像遇到了一个 <a href="Exit.htm">Exit</a> 命令。为了避免此情况，在第三个参数里包含 <strong>UseErrorLevel</strong> 字串。</p>

<p>如果 <em>Target</em> 是一个精确的路径，性能可能有细微地改善，例如 Run, C:\Windows\Notepad.exe "C:\My Documents\Test.txt" 而不是 Run, C:\My Documents\Test.txt </p>

<p>特殊的 <a href="../misc/CLSID-List.htm">CLSID 文件夹</a>可以通过 Run 被打开。例如：</p>
<pre>Run ::{20d04fe0-3aea-1069-a2d8-08002b30309d}  <em>;打开&ldquo;我的电脑&rdquo;文件夹。</em>
Run ::{645ff040-5081-101b-9f08-00aa002f954e}  <em>;打开回收站。</em></pre>

<p>系统动作相当于在资源管理器中一个文件的右键菜单动作可用。如果一个文件没有一个动作来运行，这特殊的文件类型的默认动作（通常是&ldquo;打开&rdquo;）将被使用。如果指定了，这动作应该跟在 target 文件名的后面。下列动作是当前被支持的：</p>

<table border="1" bordercolor="#c0c0c0" cellpadding="3" cellspacing="0" width="100%">
  <tr>
    <td width="8%">properties</td>
    <td width="92%">为指定文件显示资源管理器的属性窗口。例如：Run, properties "C:\My File.txt"<br>
注意：当脚本终止的时候属性窗口会自动关闭。为避免这种情况，使用 <a href="WinWait.htm">WinWait</a> 来等待窗口出现，然后用 <a href="WinWaitClose.htm">WinWaitClose</a> 等待用户去关闭它。</td>
    </tr>
  <tr>
    <td>find</td>
    <td>打开一个资源管理器的搜索助理窗口或者在指定文件夹的查找文件窗口。例如：Run, find D:\ </td>
    </tr>
  <tr>
    <td>explore</td>
    <td>在指定文件夹打开一个资源管理器窗口。例如：Run, explore %A_ProgramFiles%</td>
    </tr>
  <tr>
    <td>edit</td>
    <td>打开一个指定的文件来编辑。如果指定的文件类型没有&ldquo;编辑&rdquo;动作与之关联，它可能不起作用。例如：Run, edit "C:\My File.txt" </td>
    </tr>
  <tr>
    <td>open</td>
    <td>打开指定的文件 (一般不需要，因为这是大多数文件类型的默认动作)。例如：Run, open "My File.txt"</td>
    </tr>
  <tr>
    <td>print</td>
    <td>使用与之关联的应用程序来打印指定的文件，如果有的话。例如：Run, print "My File.txt"</td>
    </tr>
</table>

<p>当 RunWait 在等待状态时，新的<a href="../misc/Threads.htm">线程</a>能通过<a href="../Hotkeys.htm">热键</a>，<a href="Menu.htm">自定义菜单项</a>或者<a href="SetTimer.htm">定时器</a>来运行。</p>

<h3>相关命令</h3>
<p><a href="RunAs.htm">RunAs</a>, <a href="Process.htm">Process</a>, <a href="Exit.htm">Exit</a>, <a href="../misc/CLSID-List.htm">CLSID List</a>, <a href="DllCall.htm">DllCall</a> </p>

<h3>范例</h3>
<pre class="NoIndent">Run, Notepad.exe, C:\My Documents, max<br><br>Run, mailto:someone@domain.com?subject=This is the subject line&amp;body=This is the message body's text.<br>Run, ReadMe.doc, , Max UseErrorLevel  <em>;以最小化运行并且如果失败则不显示对话框。</em>
if ErrorLevel = ERROR
    MsgBox 无法启动文档。

RunWait, %comspec% /c dir c:\ &gt;&gt;c:\DirTest.txt, , min
Run, c:\DirTest.txt
Run, properties c:\DirTest.txt

Run, www.autohotkey.com <em>;也就是说能运行任何 URL。</em>
Run, mailto:someone@somedomain.com  <em>;这将打开默认的 e-mail 程序。</em>

Run ::{20d04fe0-3aea-1069-a2d8-08002b30309d}  <em>;打开&ldquo;我的电脑&rdquo;文件夹。</em>
Run ::{645ff040-5081-101b-9f08-00aa002f954e}  <em>;打开回收站。</em>

<em>;连续执行多个命令，在每个命令之间用&ldquo;&amp;&amp;&rdquo;：</em>
Run, %comspec% /c dir /b &gt; C:\list.txt &amp;&amp; type C:\list.txt &amp;&amp; pause
</pre>


</body>
</html>
